home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3n / t_getstate.z / t_getstate
Encoding:
Text File  |  2002-10-03  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. tttt____ggggeeeettttssssttttaaaatttteeee((((3333NNNN))))                                                  tttt____ggggeeeettttssssttttaaaatttteeee((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt______gggg_eeee_tttt_ssss_tttt_aaaa_tttt_eeee - get the current state
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_ffff_dddd_eeee_ffff ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_xxxx_tttt_iiii_...._hhhh_>>>>
  14.      _####_eeee_llll_ssss_eeee
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_tttt_iiii_uuuu_ssss_eeee_rrrr_...._hhhh_>>>>
  16.      _####_eeee_nnnn_dddd_iiii_ffff
  17.  
  18.      _iiii_nnnn_tttt _tttt______gggg_eeee_tttt_ssss_tttt_aaaa_tttt_eeee_((((_ffff_dddd_))))
  19.      _iiii_nnnn_tttt _ffff_dddd_;;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      The _tttt______gggg_eeee_tttt_ssss_tttt_aaaa_tttt_eeee function returns the current state of the provider
  23.      associated with the transport endpoint specified by _ffff_dddd.
  24.  
  25.      This function resides within both the X/Open compliant _llll_iiii_bbbb_xxxx_nnnn_eeee_tttt and the
  26.      SVR4 compliant _llll_iiii_bbbb_nnnn_ssss_llll Network Services libraries.  Network Services
  27.      applications which require X/Open compliance must link-load with _----_llll_xxxx_nnnn_eeee_tttt.
  28.      Network Services applications which require SVR4 compliance must link-
  29.      load with _----_llll_nnnn_ssss_llll.
  30.  
  31.      On failure, _tttt______eeee_rrrr_rrrr_nnnn_oooo may be set to one of the following:
  32.  
  33.      _TTTT_BBBB_AAAA_DDDD_FFFF             The specified file descriptor does not refer to a
  34.                        transport endpoint.
  35.  
  36.      _TTTT_SSSS_TTTT_AAAA_TTTT_EEEE_CCCC_HHHH_NNNN_GGGG        The transport provider is undergoing a state change.
  37.  
  38.      _TTTT_SSSS_YYYY_SSSS_EEEE_RRRR_RRRR           A system error has occurred during execution of this
  39.                        function.
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      _tttt______oooo_pppp_eeee_nnnn(3N)
  43.  
  44. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  45.      _tttt______gggg_eeee_tttt_ssss_tttt_aaaa_tttt_eeee returns the current state on successful completion and -1 on
  46.      failure and _tttt______eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.  The current state may
  47.      be one of the following:
  48.  
  49.      _TTTT______UUUU_NNNN_BBBB_NNNN_DDDD        unbound
  50.  
  51.      _TTTT______IIII_DDDD_LLLL_EEEE         idle
  52.  
  53.      _TTTT______OOOO_UUUU_TTTT_CCCC_OOOO_NNNN       outgoing connection pending
  54.  
  55.      _TTTT______IIII_NNNN_CCCC_OOOO_NNNN        incoming connection pending
  56.  
  57.      _TTTT______DDDD_AAAA_TTTT_AAAA_XXXX_FFFF_EEEE_RRRR     data transfer
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. tttt____ggggeeeettttssssttttaaaatttteeee((((3333NNNN))))                                                  tttt____ggggeeeettttssssttttaaaatttteeee((((3333NNNN))))
  71.  
  72.  
  73.  
  74.      _TTTT______OOOO_UUUU_TTTT_RRRR_EEEE_LLLL       outgoing orderly release (waiting for an orderly release
  75.                     indication)
  76.  
  77.      _TTTT______IIII_NNNN_RRRR_EEEE_LLLL        incoming orderly release (waiting for an orderly release
  78.                     request)
  79.  
  80.      If the provider is undergoing a state transition when _tttt______gggg_eeee_tttt_ssss_tttt_aaaa_tttt_eeee is
  81.      called, the function will fail.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.